home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3x / aslistmachines.z / aslistmachines
Encoding:
Text File  |  2002-10-03  |  3.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaasssslllliiiissssttttmmmmaaaacccchhhhiiiinnnneeeessss((((3333xxxx))))                                          aaaasssslllliiiissssttttmmmmaaaacccchhhhiiiinnnneeeessss((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aslistmachines - enumerate machines in an array
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<aaaarrrrrrrraaaayyyyssssvvvvccccssss....hhhh>>>>
  13.  
  14.      aaaassssmmmmaaaacccchhhhiiiinnnneeeelllliiiisssstttt____tttt ****aaaasssslllliiiissssttttmmmmaaaacccchhhhiiiinnnneeeessss((((aaaasssssssseeeerrrrvvvveeeerrrr____tttt SSSSeeeerrrrvvvveeeerrrr,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr ****NNNNaaaammmmeeee))));;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _a_s_l_i_s_t_m_a_c_h_i_n_e_s function returns a list of the machines that are
  18.      members of the array specified by NNNNaaaammmmeeee.  If NNNNaaaammmmeeee is NULL, the machines
  19.      that are members of the default array is returned.
  20.  
  21.      The SSSSeeeerrrrvvvveeeerrrr parameter specifies an optional array server token, which can
  22.      be used to direct the request to a specific array services daemon.  If
  23.      NULL is specified instead, the request will be processed by the default
  24.      array services daemon (see _a_r_r_a_y(1) for more information on how the
  25.      default array services daemon is selected).  For more details on creating
  26.      an array server token, see _a_s_o_p_e_n_s_e_r_v_e_r(3X).
  27.  
  28.      Each machine is described by an aaaassssmmmmaaaacccchhhhiiiinnnneeee____tttt structure, and the entire
  29.      list is contained in an aaaassssmmmmaaaacccchhhhiiiinnnneeeelllliiiisssstttt____tttt structure.  Both of these are
  30.      defined in <<<<aaaarrrrrrrraaaayyyyssssvvvvccccssss....hhhh>>>>.  The storage for these structures is allocated
  31.      using _m_a_l_l_o_c(3) and can be released using _a_s_f_r_e_e_m_a_c_h_i_n_e_l_i_s_t(3X).
  32.  
  33. NNNNOOOOTTTTEEEESSSS
  34.      _a_s_l_i_s_t_m_a_c_h_i_n_e_s is found in the library "libarray.so", and will be loaded
  35.      if the option "-larray" is used with _c_c(1) or _l_d(1).
  36.  
  37. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  38.      aserrorcode(3X), asfreemachinelist(3X), aslistarrays(3X),
  39.      asopenserver(3X).
  40.  
  41. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  42.      _a_s_l_i_s_t_m_a_c_h_i_n_e_s returns a pointer to an aaaassssmmmmaaaacccchhhhiiiinnnneeeelllliiiisssstttt____tttt structure if
  43.      successful.  If unsuccessful, NULL is returned and _a_s_e_r_r_o_r_c_o_d_e(3X) is set
  44.      appropriately.
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.